/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.up.kafka.sender;

import com.up.kafka.productor.MessageRecord;
import com.up.kafka.productor.MsgCallBack;

import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

/**
 * @author: baiMl
 * @title: MessageSender
 * @projectName: 海联技术中台V2.0
 * @depart 软件事业部
 * @description: 消息发送包装接口, 为了融合各种类型的消息而包装
 * @date: 2022/4/24 17:16
 */
public interface MessageSender {
    /**
     * 发送一次消息（不带分区）
     *
     * @param key     关键key
     * @param message 消息内容
     * @param topic   主题
     * @param <V>     消息类型
     * @throws IOException IO 异常
     */
    <V> void sendOnce(String key, V message, String topic) throws IOException;

    /**
     * 发送一次消息（带分区）
     *
     * @param key       关键key
     * @param message   消息内容
     * @param topic     主题
     * @param partition 分区
     * @param <V>       消息类型
     * @throws IOException IO 异常
     */
    <V> void sendOnce(String key, V message, String topic, Integer partition) throws IOException;

    /**
     * 发送同步消息
     *
     * @param <V>       消息类型
     * @param key       关键key
     * @param message   消息内容
     * @param topic     主题
     * @param partition 分区
     * @return 发送结果
     * @throws ExecutionException   执行一次
     * @throws InterruptedException 中断异常
     * @throws IOException          IO 异常
     */
    <V> Object sendSync(String key, V message, String topic, Integer partition) throws ExecutionException, InterruptedException, IOException;

    /**
     * 发送同步消息
     *
     * @param key     关键key
     * @param message 消息内容
     * @param topic   主题
     * @param <V>     消息类型
     * @return 发送结果
     * @throws ExecutionException   执行一次
     * @throws InterruptedException 中断异常
     * @throws IOException          IO 异常
     */
    <V> Object sendSync(String key, V message, String topic) throws ExecutionException, InterruptedException, IOException;

    /**
     * 发送同步消息
     *
     * @param key      关键key
     * @param message  消息内容
     * @param topic    主题
     * @param <V>      消息类型
     * @param time     阻塞等待事件
     * @param timeUnit 时间单位
     * @return 发送结果
     * @throws ExecutionException   执行一次
     * @throws InterruptedException 中断异常
     * @throws TimeoutException     超时异常
     * @throws IOException          IO 异常
     */
    <V> Object sendSync(String key, V message, String topic, long time,
                        TimeUnit timeUnit)
            throws ExecutionException, InterruptedException, TimeoutException, IOException;

    /**
     * 发送同步消息
     *
     * @param key       关键key
     * @param message   消息内容
     * @param topic     主题
     * @param <V>       消息类型
     * @param time      阻塞等待事件
     * @param timeUnit  时间单位
     * @param partition 分区
     * @return 发送结果
     * @throws ExecutionException   执行一次
     * @throws InterruptedException 中断异常
     * @throws TimeoutException     超时异常
     * @throws IOException          IO 异常
     */
    <V> Object sendSync(String key, V message, String topic, Integer partition, long time,
                        TimeUnit timeUnit)
            throws ExecutionException, InterruptedException, TimeoutException, IOException;

    /**
     * 消息异步发送，成功 or 失败执行回调进行业务处理
     *
     * @param key       关键key
     * @param message   消息内容
     * @param topic     主题
     * @param partition 分区
     * @param callBack  回调接口
     * @param <V>       消息类型
     * @throws IOException 消息发送IO异常
     */
    <V> void sendCallBack(String key, V message, String topic, Integer partition, MsgCallBack<V> callBack) throws IOException;

    /**
     * 消息异步发送，成功 or 失败执行回调进行业务处理
     *
     * @param key      关键key
     * @param message  消息内容
     * @param topic    主题
     * @param callBack 回调接口
     * @param <V>      消息类型
     * @throws IOException 消息发送IO异常
     */
    <V> void sendCallBack(String key, V message, String topic, MsgCallBack<V> callBack) throws IOException;

    /**
     * 包装发送记录对象
     *
     * @param key       关键key
     * @param message   消息内容
     * @param topic     主题
     * @param partition 分区
     * @param <V>       消息类型
     * @return 返回记录对象
     */
    default <V> MessageRecord<V> wrapperMessageRecord(String key, V message, String topic, Integer partition) {
        return new MessageRecord<>(topic, key, message, partition);
    }
}
